Payflow Pro Integration

Payflow Pro is a scalable, fully integrated payment processing solution, which means it can meet the needs of a business with moderate to large transaction numbers. With Payflow Pro your members and customers don't leave your site to enter their credit card information and you have full control over the look and feel of the order form and the payment functionality on your site. Payflow Pro can be configured to work with most e-commerce applications for a controlled buyer experience.

Setting Up Payflow Pro

Client Tasks

The client must set up the Internet Merchant Account that will be used for their Payflow Pro integration. They must also set up a Payflow Pro account and purchase the required TLS 1.2.

Set Up The Internet Merchant Account and the Payflow Pro Account

In order to use Payflow Pro, clients must have an Internet Merchant Account, primarily for depositing and refunding online payments. Every online merchant needs to have an Internet Merchant Account to accept credit cards over the Internet. An Internet Merchant Account is essentially a bank account for an online business it allows merchants to deposit and refund online payments. If you haven't opened an Internet Merchant Account, Payflow Pro has partnered with several Internet Merchant Account providers and can help you set up an account.

Clients may use an existing merchant account as long as it is specifically designed for Internet transactions. If you have an existing merchant account, check with your acquiring institution to see if they can provide you with an Internet merchant account. Ensure that it can be set up to use Payflow Pro through the Payflow Pro supported processing networks.

To setup a merchant account, you must have a checking account with a U.S. bank. If you do not have an account with a U.S. bank, many acquiring institutions can assist you. Your acquiring institution must set up your account to use one of the following processing networks: EDS, First Data Merchant Services, Norwest, Nova, Paymentech, TeleCheck, Vital.

For a partial listing of all banks that can set up your merchant account to use Payflow Pro, you can visit the Payflow Pro website.

Your account must be set up with the bank to use PayFlow Pro as the software type or the payment gateway.

Note: You are limited to one internet merchant account per Payflow Pro account.

To set up your account to use Payflow Pro, complete the following steps:

  1. Complete the registration process for Payflow Pro. You will need to provide the following:
  2. Once a Payflow Pro account is setup, the you must provide Abila with your username, password and partner. (Usually the partner is Payflow Pro.)
  3. Make sure the account is in Test Mode

Abila Tasks

Abila staff will perform the necessary tasks to integrate netFORUM with Payflow Pro.

netFORUM Integration to Payflow Pro

Once clients have successfully setup the Payflow Pro account and purchased the TLS access, that information should be sent to your Abila Project Manager. Your project manager will ensure that the TLS (for hosted clients) is loaded onto your servers and the Payflow Pro integration is configured.

Note: Abila purchases the TLS access for hosted clients.

Additional Abila Setup Tasks:

  1. Abila will modify the netFORUM setup to ensure the correct connection string for the client account on both your 'live' and 'test' sites. At go-live, Abila will update to ensure the connection string for the live site points to the live Payflow Pro account.
  2. Abila will then configure the netFORUM system options to pick Payflow processor as the processor

Costs

Consult with your Abila representative for information on setup costs. See Integration Costs for more information.

Please check with PayPal for the latest pricing information.

Account Configuration

Payflow Pro provides a test program that is used to test your configuration. Please run this program to see if any issues arise.

Testing Payflow Pro from netFORUM

To test Payflow Pro, do the following:

  1. Add a credit card (Visa, MC, AmEx, etc.) as a payment method to each business unit that will accept credit cards or ACH payments via your Payflow Pro integration with netFORUM .
  2. Purchase a product in netFORUM using the credit card or ACH payment method you set up.

Note: Keep transactions under $1000.00 or else you may get a "Credit Card Declined" error.

For credit cards, use the following test account information (provided by Payflow Pro):

Use any cardholder name, and any expiration date that falls after the current month.

The CVV code can be any 3 digits and is not required.

For an ACH transaction, enter the test account information as follows (provided from PayFlow Pro):

  1. Go to the payment profile page to view the authorization code for the test credit card or ACH transaction.

Reconciling transactions between netFORUM and Payflow Pro

Payflow Pro Manager

Payflow Pro Manager is an online merchant support service for registered Payflow Pro customers. With Payflow Pro Manager you can manage your transaction activity and Payflow Pro account. Payflow Pro Manager's tools give you access to customized reports, search utilities, transaction responses, a manual transaction terminal, and much more. (Additional information is provided on the Payflow Pro website)

 

DescriptionPayflow Pro FieldnetFORUM Field
Generated in Payflow ProTransaction IDpayment reference number
Generated in Payflow Proauthorization codeauthorization code
Generated in Payflow ProSupplier Reference Number and Invoice Number)not stored in netFORUM
Generated in netFORUMComment 1payment batch
Generated in netFORUMComment 2system date
The IP address of the device used to perform the electronic transactionClient IP AddressIP address is not stored in netFORUM. This is the IP address of the eWeb or iWeb user who added the payment. This can be useful for tracing the identity of the user and for fraud investigations.
Generated in netFORUMPurchase Order Number and Customer Codecustomer ID

 

Credit Card Gateway

The Credit Card Gateway is used only for clients who have multiple merchant accounts.

Caution! Please do not add records here. Allow your Abila representative to manage this data. For 99% of netFORUM implementations, there should not be any records here.

Do not add a record here unless you are using multiple Payflow Pro merchant accounts, as it will break your integration. Please observe the instructions on the form.

The credit card gateway feature allows you to set up connectivity with multiple payment processing networks that verify and approve transactions (by routing the information to the consumer's bank for approval) over a Transport Layer Security (TLS) 1.2 connection. The system can be set up for all major credit cards.

To use the multiple credit card gateway functionality, the system administrator needs to add the credit card gateway entries into your system's web.config files (iWeb and eWeb), and add the gateway name using this process.

Credit card gateways are selected when you set up payment methods.

Note: A credit card gateway is used only when you have multiple PayFlow Pro internet merchant accounts. If you do not have multiple accounts, then do not add any records to the setup area.

Please view the Credit Card Gateway Setup help topic for more information on setting up credit card gateways.

Troubleshooting: Potential Errors

Fraud Option Configuration

Note: Fraud options need to be configured on your Payflow account. Abila cannot make these changes, and does not provide recommendations on the settings because the settings must conform with your business practices.

If you run the test program and get the following result:

RESULT=126&PNREF=V63A0A88EAA7&RESPMSG=Under review by Fraud Service&AUTHCODE=631
PNI&AVSADDR=N&AVSZIP=N&PREFPSMSG=No Rules Triggered&POSTFPSMSG=Review AVS.

it means there is a problem in the way the Fraud Options are configured on your Payflow account. To remedy this issue, please contact Payflow Pro Technical Support at 888-883-9770.

Invalid Class String Error Message

When running any Payflow Pro transaction, the following error appears:

Configuration error in Payflow Pro Invalid class string

Error Reason

The netFORUM PayFlow Pro integration requires an installation of PayFlow Pro on the web server. This message indicates that the installation has not been done yet. This should NOT happen on a stable site. This should happen only on a new--and incomplete--server configuration.

The error text "invalid class string" is an error returned from Microsoft programs when a program (in this case, netFORUM) attempts to instantiate a DLL, and the DLL file cannot be found.

Resolution

Install PayFlow Pro on the web server.

Tips: